Skip to content

App menu name updates#10069

Merged
rosieyohannan merged 8 commits intomainfrom
cursor/DOC-26-app-menu-name-updates-35dc
Mar 16, 2026
Merged

App menu name updates#10069
rosieyohannan merged 8 commits intomainfrom
cursor/DOC-26-app-menu-name-updates-35dc

Conversation

@rosieyohannan
Copy link
Contributor

@rosieyohannan rosieyohannan commented Mar 12, 2026

[!NOTE]

You may find that there are errors for the vale/lint job that are unrelated to your change.
Vale checks the whole file when a change is made so if there are existing issues on the page they will be flagged.
You can ignore lint errors outside your changes and the CircleCI docs team will address them for you.
Vale logs are advisory to help all contributors create content that conforms to our style guide. The vale/lint job will not prevent changes from being published.

Description

Updated references to CircleCI app sidebar menu items to reflect recent UI changes.

Reasons

The CircleCI app sidebar menu items have been renamed. This PR updates the documentation to ensure consistency with the current application interface, resolving DOC-26.

Specifically, the following changes were made:

  • Organization Home → Home
  • Chunk Tasks → Tasks
  • Self-Hosted Runner → Runners
  • Organization Settings → Org

Content checks

Please follow our style when contributing to CircleCI docs. View our style guide or check out our CONTRIBUTING.md for more information.

Preview your changes:

  • View the Vale linter results, select the ci/circleci: lint job at the bottom of your PR. You will be redirected to the vale/lint job output in CircleCI.
  • Preview your changes, select the ci/circleci: build job at the bottom of your PR and you will be redirected to CircleCI. Select the Artifacts tab and select index.html to open a preview version of the docs site built for your latest commit.

Take a moment to check through the following items when submitting your PR (this is just a guide so will not be relevant for all PRs):

Content structure:

  • Break up walls of text by adding paragraph breaks.
  • Consider if the content could benefit from more structure, such as lists or tables, to make it easier to consume.
  • Consider whether the content would benefit from more subsections (h2-h6 headings) to make it easier to consume.
  • Include relevant backlinks to other CircleCI docs/pages.

Formatting:

  • Keep the title between 20 and 70 characters.
  • Check all headings h1-h6 are in sentence case (only first letter is capitalized).

Linear Issue: DOC-26

Open in Web Open in Cursor 

@cursoragent @rosieyohannan
Update CircleCI app sidebar menu names in documentation
fc67d57 
- Changed 'Organization Home' to 'Home'
- Changed 'Chunk Tasks' to 'Tasks'
- Changed 'Self-Hosted Runners' to 'Runners' (menu references)
- Changed 'Organization Settings' to 'Org'

Updated all instances across documentation files including:
- User guides and tutorials
- Configuration and setup instructions
- Security and permissions documentation
- Integration guides
- API and CLI documentation
- Orb documentation

Resolves DOC-26

Co-authored-by: Rosie Yohannan <rosieyohannan@users.noreply.github.com>
@cursor
Copy link

cursor bot commented Mar 12, 2026

Cursor Agent can help with this pull request. Just @cursor in comments and I'll start working on changes in this branch.
Learn more about Cursor Agents

@linear
Copy link

linear bot commented Mar 12, 2026

DOC-26 App menu updates

rosieyohannan
rosieyohannan commented Mar 12, 2026
View reviewed changes
Copy link
Contributor Author

@rosieyohannan rosieyohannan left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@cursoragent changes required

@cursor
Copy link

cursor bot commented Mar 12, 2026 •
edited
Loading

I've addressed all the feedback from the PR review. Here's what was fixed:

Changes Made:

  1. Reverted incorrect OpenAI change - The "Organization Settings" in the OpenAI context was incorrectly changed to "Org Settings". This has been reverted back to "Organization Settings" since it refers to OpenAI's interface, not CircleCI's.

  2. Improved formatting consistency:

    • Updated to use menu:Org[Overview] syntax instead of **Org > Overview** format
    • Changed "click" to "select" for consistency
    • Changed "on the left navigation" to "from the sidebar"
    • Changed https://app.circleci.com/ to link:https://app.circleci.com/ format
    • Replaced btn:[Org] with simple bold *Org* where more appropriate

  3. Updated phrasing to be more consistent with CircleCI docs style guide (e.g., "In the CircleCI web app, select Org from the sidebar")

All changes have been committed and pushed to the branch. The PR should now conform to the CircleCI documentation style guidelines.

Open in Web Open in Cursor 

cursoragent and others added 4 commits March 12, 2026 15:05
@cursoragent @rosieyohannan
Address PR feedback: fix formatting and incorrect OpenAI reference
ca4edb4 
- Reverted OpenAI 'Organization Settings' change (was incorrectly changed to 'Org Settings')
- Updated to use menu: syntax for consistency (menu:Org[...])
- Changed 'click' to 'select' and 'go to' to more consistent phrasing
- Changed 'on the left navigation' to 'from the sidebar'
- Changed https:// to link: syntax where appropriate
- Removed btn:[] formatting where simple bold (*) is more appropriate

Co-authored-by: Rosie Yohannan <rosieyohannan@users.noreply.github.com>
@cursoragent @rosieyohannan
Update Org > Integrations to Org > VCS Connections
50c928b 
The Integrations page in the CircleCI app has been moved to VCS Connections.
Updated all references throughout the documentation to reflect this change.

Changes:
- menu:Org[Integrations] → menu:Org[VCS Connections]
- 'Integrations page under Org' → 'VCS Connections page under Org'
- 'Navigate to **Integrations** within **Org**' → 'Navigate to **VCS Connections** within **Org**'

Co-authored-by: Rosie Yohannan <rosieyohannan@users.noreply.github.com>
@cursoragent @rosieyohannan
Revert changes to archive folder
4fc7a47 
Archive files should not be modified as they contain historical documentation.

Co-authored-by: Rosie Yohannan <rosieyohannan@users.noreply.github.com>
@rosieyohannan
Merge branch 'main' into cursor/DOC-26-app-menu-name-updates-35dc
142365b
@rosieyohannan rosieyohannan marked this pull request as ready for review March 16, 2026 14:50
@rosieyohannan rosieyohannan requested review from a team as code owners March 16, 2026 14:50
@rosieyohannan
Apply suggestions from code review
32235ec 
Co-authored-by: Rosie Yohannan <rosie@circleci.com>
@rosieyohannan rosieyohannan merged commit 93932a0 into main Mar 16, 2026
2 of 3 checks passed
@rosieyohannan rosieyohannan deleted the cursor/DOC-26-app-menu-name-updates-35dc branch March 16, 2026 22:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@soulchips soulchips soulchips approved these changes

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@rosieyohannan @soulchips @cursoragent